.\" Man page generated from reStructuredText.
.
.TH "MONMAPTOOL" "8" "Jan 23, 2022" "dev" "Ceph"
.SH NAME
monmaptool \- ceph monitor cluster map manipulation tool
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH 提纲
.nf
\fBmonmaptool\fP <action> [options] \fImapfilename\fP
.fi
.sp
.SH 描述
.sp
\fBmonmaptool\fP 工具用于创建、查看、修改用于
Ceph 分布式存储系统的监视器集群运行图。
监视器图只是在 Ceph 分布式系统中定义了几个固定的地址，
其他所有守护进程绑定到任意地址、
并注册到监视器。
.sp
用 \-\-create 选项创建新图时，
会创建新的随机 UUID ，
此选项后还应加一或多个监视器地址。
.sp
Ceph 监视器 v1 版信使协议的端口是 6789 ，
而 v2 版协议的端口是 3300 。
.sp
调用一次可以执行多个动作。
.SH 选项
.INDENT 0.0
.TP
.B \-\-print
在所有修改完成后，
打印一份监视器图的纯文本转储。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-feature\-list [plain|parseable]
罗列出已启用的功能、还有可用的。
.sp
默认返回的是人类可读的输出。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-create
新建一监视器图，它有新的 UUID
（用它可创建个新的空 Ceph 文件系统）。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-clobber
更改时允许 monmaptool 覆盖 mapfilename 。
.sp
只有加 \fI\-\-create\fP 时有用。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-generate
基于命令行参数或配置文件中的配置生成新 monmap ，
配置来源优先级如下：
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP 1. 3
\fB\-\-monmap filename\fP 指定要载入的 monmap
.IP 2. 3
\fB\-\-mon\-host \(aqhost1,ip2\(aq\fP 指定一系列主机或 IP 地址
.IP 3. 3
配置文件中包含 \fBmon addr\fP 选项的 \fB[mon.foo]\fP
段落。请注意，不建议此方法、且将来的版本会删除此选项。
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-filter\-initial\-members
用 \fBmon initial members\fP 选项的设置过滤初始 monmap ，
不在此列表内的监视器将被删除、
没在图内的初始成员将用假地址加入。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-add name ip[:port]
把指定 ip:port 的监视器加入图中。
.sp
如果启用了 \fInautilus\fP 功能，却没指定端口，
会为两种信使协议都增加监视器。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-addv name [protocol:ip:port[,...]]
以 version:ip:port 格式向运行图增加监视器。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-rm name
从图中删除 ip:port 监视器。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-fsid uuid
把 fsid 设置为指定的 uuid ，如果 \-\-create 时没指定，将会随机生成一个。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-feature\-set value [\-\-optional|\-\-persistent]
启用一个功能。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-feature\-unset value [\-\-optional|\-\-persistent]
禁用一个功能。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-enable\-all\-features
启用所有支持的协议。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-set\-min\-mon\-release release
设置 min_mon_release 的值。
.UNINDENT
.SH 实例
.sp
新建一个有三个监视器的新图（为新的 Ceph 集群）：
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
monmaptool \-\-create \-\-add nodeA 192.168.0.10 \-\-add nodeB 192.168.0.11 \e
  \-\-add nodeC 192.168.0.12 \-\-enable\-all\-features \-\-clobber monmap
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
显示监视器图内容：
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
monmaptool \-\-print monmap
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
替换一个监视器：
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
monmaptool \-\-rm nodeA monmap
monmaptool \-\-add nodeA 192.168.0.9 monmap
.ft P
.fi
.UNINDENT
.UNINDENT
.SH 使用范围
.sp
\fBmonmaptool\fP 是 Ceph 的一部分，这是个伸缩力强、开源、分布式的存储系统，更多信息参见 \fI\%https://docs.ceph.com\fP 。
.SH 参考
.sp
ceph(8),
crushtool(8),
.SH COPYRIGHT
2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
.\" Generated by docutils manpage writer.
.
